home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 422_03 / pcutils.doc < prev    next >
Text File  |  1994-02-14  |  50KB  |  1,378 lines
  1.    
  2.    
  3.    
  4.    
  5.    
  6.    
  7.    
  8.    
  9.    
  10.    
  11.    
  12.    
  13.    
  14.    
  15.    
  16.    
  17.    
  18.    
  19.    
  20.    
  21.                                      P C
  22.                                   Utilities
  23.    
  24.                                A set of useful
  25.                                Utility Programs
  26.                                    For the
  27.                             IBM Personal Computer
  28.    
  29.    
  30.    
  31.    
  32.    
  33.                                  Release 1.3
  34.    
  35.                               Revised: 29-Jul-90
  36.    
  37.    
  38.    
  39.    
  40.    
  41.    
  42.    
  43.    
  44.    
  45.    
  46.                       Copyright 1983,1990 Dave Dunfield
  47.                              All rights Reserved
  48.    PC Utilities                                                     Page: 1
  49.  
  50.  
  51.    1. INTRODUCTION
  52.    
  53.          PC Utilities is a collection of small but useful utility  programs
  54.       for the IBM PC under MS-DOS.
  55.    
  56.          Included in the package are:
  57.    
  58.            CHATTR  - Change file attributes.
  59.            DIFF    - Compare two text files and report differences.
  60.            DR      - Scan a directory tree for OLDest and NEWest file
  61.            DUMP    - HEX or OCTAL dump of file(s) contents.
  62.            DUS     - Disk Usage Summary
  63.            EDT     - A screen oriented text editor.
  64.            EXTRACT - Extact a section from a larger file.
  65.            FDIR    - A screen oriented directory shell.
  66.            FSCAN   - Scan for altered files.
  67.            HEXED   - A screen oriented binary editor.
  68.            LOCATE  - Search for text strings.
  69.            OFF     - CRT screen saved.
  70.            RETAB   - Retabulate files to different tab stops.
  71.            SIZE    - Display size of file(s) in lines/characters.
  72.            TIMEIT  - Times the execution of another command.
  73.            TYPESET - An ASCII document formatter.
  74.            WDIR    - Walk a directory & execute commands.
  75.    
  76.          The following pages contain detailed descriptions of each  utility
  77.       program, and its operating syntax.
  78.    
  79.          The PCUTILS "package" (software and documentation) is copyrighted,
  80.       and may not be re-distributed for profit or other commercial purposes
  81.       without my written permission. If you  find  PCUTILS  useful,  please
  82.       help  me  continue  to  support  and  enhance   it   by   sending   a
  83.       "registration" fee of $24.95 to this address:
  84.    
  85.                           Dunfield Development Systems
  86.                           P.O. Box 31044
  87.                           Nepean, Ontario (Canada)
  88.                           K2B 8S8
  89.    
  90.          Please make your cheque  or  money  order  payable  to  "David  or
  91.       Sharleen Dunfield". If you choose not to order the  complete  PCUTILS
  92.       package, please discontinue using PCUTILS within thirty days.
  93.    
  94.          PCUTILS is provided on an "as is" basis, with no warranty  of  any
  95.       kind. In no event shall the author be liable for any damages  arising
  96.       from its use or distribution.
  97.    PC Utilities - CHATTR                                            Page: 2
  98.  
  99.  
  100.    2. CHATTR - Change file attributes
  101.    
  102.          CHATTR is a simple utility program which allows you to easily  set
  103.       the attribytes of DOS files.
  104.    
  105.          The form of the CHATTR command is:
  106.    
  107.                      CHATTR <filespec> <+|-attribute ...>
  108.    
  109.          The available attributes are:
  110.    
  111.    
  112.            +/-A    - Add/Remove ARCHIVE bit
  113.            +/-H    - Add/Remove HIDDEN bit
  114.            +/-R    - Add/Remove READ-ONLY bit
  115.            +/-S    - Add/Remove SYSTEM bit
  116.    
  117.          Examples:
  118.    
  119.            chattr *.* -a
  120.            chattr \dos\*.* +r
  121.            chattr C:\command.com +h +r
  122.    PC Utilities - DIFF                                              Page: 3
  123.  
  124.  
  125.    3. DIFF - A file compare program
  126.    
  127.          DIFF is a program which  taks  two  text  files,  and  performs  a
  128.       line-by-line comparison of them. If more than one differing  line  is
  129.       found, DIFF considers and reports this is a  single  difference.  The
  130.       'r=' parameter controls how many identical lines DIFF  must  find  in
  131.       the file before it considers a difference to be ended.
  132.    
  133.          Any time a difference is found between the  files,  DIFF  displays
  134.       the line numbers indicating where the difference occurs, followed  by
  135.       the differing lines from the first file (Preceeded by '<'),  and  the
  136.       differing lines from the second file (Precceded by '>').
  137.    
  138.          The form of the DIFF command is:
  139.    
  140.                       DIFF <file1> <file2> [options ...]
  141.    
  142.          The available options are:
  143.    
  144.            -d      - Inhibit display of differing lines
  145.            -l      - Inhibit display of line numbers
  146.            r=num   - Specify minimum # of lines to re-synchronize
  147.    
  148.          Examples:
  149.    
  150.            diff program.asm program.bak
  151.    PC Utilities - DR                                                Page: 4
  152.  
  153.  
  154.    4. DR - Date Ranger
  155.    
  156.          DR is a utility which will quickly scan a disk or  directory,  and
  157.       report on the oldest and newest files it finds. It  is  quite  useful
  158.       for determing the last date/time a change was made etc.
  159.    
  160.          The form of the DR command is:
  161.    
  162.                        DR <directory ...> [options ...]
  163.    
  164.          The available options are:
  165.    
  166.            -? or ? - Display help info.
  167.            -h      - Exclude HIDDEN files
  168.            -n      - Inhibit display of NEWest file
  169.            -o      - Inhibit display of OLDest file
  170.            -r      - Inhibit recursion into sub-directories
  171.            -s      - Exclude SYSTEM files
  172.            -v      - Inhibit startup message (header)
  173.    
  174.          Examples:
  175.    
  176.            dr c:\myprogs
  177.    PC Utilities - DUMP                                              Page: 5
  178.  
  179.  
  180.    5. DUMP - File dump
  181.    
  182.          DUMP is a utility which displays the contents of one or more files
  183.       in either HEX/ASCII or OCTAL/ASCII "dump" format. Wildcards (*,?) are
  184.       allowed in filenames.
  185.    
  186.          The form of the DUMP command is:
  187.    
  188.                       DUMP <filename ...> [options ...]
  189.    
  190.          The available options are:
  191.    
  192.            -f      - Pause between each file
  193.            -o      - Use OCTAL dump (default is HEX)
  194.            -p      - Pause between each block
  195.    
  196.          Examples:
  197.    
  198.            dump myprog.obj -p
  199.            dump *.COM -f -o
  200.    PC Utilities - DUS                                               Page: 6
  201.  
  202.  
  203.    6. DUS - Disk Use Summary
  204.    
  205.          The DUS utility scans a disk or directory tree, and reports on the
  206.       disk space used  within  each  subdirectory.  A  "Cumulative"  option
  207.       allows DUS to report the total  space  under  each  directory,  which
  208.       includes the contents of any subdirectories.
  209.    
  210.          The form of the DUS command is:
  211.    
  212.                       DUS <directory ...> [options ...]
  213.    
  214.          The available options are:
  215.    
  216.            -? or ? - Display help info.
  217.            -c      - Produce CUMULATIVE display
  218.            -d      - Inhibit individual display (total only)
  219.            -h      - Exclude HIDDEN files
  220.            -p      - Pause between each output page
  221.            -r      - Inhibit recursion into sub-directories
  222.            -s      - Exclude SYSTEM files
  223.            -v      - Inhibit startup message (header)
  224.    
  225.          Examples:
  226.    
  227.            dus c:\
  228.            dus c:\ d:\ -c
  229.            dus d:\archive -c
  230.    PC Utilities - EDT                                               Page: 7
  231.  
  232.  
  233.    7. EDT - Text editor
  234.    
  235.       7.1 Introduction
  236.    
  237.             EDT is a fully featured, in-memory, text editor. It operates in
  238.          either a line-by-line, or a visual screen format.
  239.    
  240.             In line-by-line mode, EDT performs no direct  screen  accesses,
  241.          and may be operated over a serial port using CTTY.
  242.    
  243.             EDT is invoked with the command 'EDT <filename>'. If the  named
  244.          file already exists, EDT will load and edit it, otherwise a  blank
  245.          file is presented. If the optional '-v'  qualifier  is